Update auf Alephino Release 5.0

Das Setup-Programm übernimmt nachfolgend aufgeführte Dateien automatisch aus der vorhandenen Alephino-Installation, sofern Sie den Modus "Update-Installation" gewählt haben:

Verzeichnis etc :

alephino.lic
alephino.usr

Verzeichnis data/photo : *.* (alle Dateien im Verzeichnis)

Update des Alephino-Servers ausgehend von Release 3.0

Zur Update-Installation werden zusätzliche Dateien bereitgestellt:

a) im Server-Verzeichnis von Alephino 3.0 :
etc/unload.cmd
etc/exec_unload.cmd
bin/unload.sh (in Unix/Linux-Version)
bin/unload.bat (in Windows-Version)

b) im Server-Verzeichnis von Alephino 5.0 :
etc/upgrade.cmd
etc/exec_upgrade.cmd
etc/statshift.txt
bin/upgrade.sh (in Unix/Linux-Version)
bin/upgrade.bat (in Windows-Version)

Die Server-Verzeichnisse der Quell- (Alephino 3.0) als auch der Zielversion (Alephino 5.0) erhalten zum Update ein zusätzliches Unterverzeichnis upgrade. Dieses dient jeweils ausschließlich als Zwischenablage für die beim Upgradeprozess auflaufenden Dateien. Das Upgrade der Alephino-Datenbank basiert auf einem kompletten Entladen (Export) und Laden (Import) jedes Datenpools. Hierbei:

findet eine Konvertierung des in der Datenbank verwendeten Zeichensatzes statt, (Alephino 5.0 arbeitet mit Unicode bzw. UTF8)
werden alle Indices sowie Verknüpfungen neu aufgebaut,
werden alle Sequenznummern neu erzeugt,
werden existierende Statistikdaten bearbeitet, da Bestandsstatistiken in Alephino 5.0 Zu- und Abgänge nunmehr monatlich zählen.

Bei der Entwicklung des nachfolgend beschriebene Upgradeverfahrens stand dessen möglichst einfache Handhabung im Vordergrund. Vor der Abarbeitung des Upgrades beachten Sie bitte:

Ist der Server von Alephino Release 3.0 als Windows-Dienst installiert, muss dieser zuvor unbedingt beendet und aus der Liste der Dienste entfernt werden. Dies trifft auch auf Alephino 5.0 Dienste zu, sollten diese bereits installiert worden sein.

Das Verfahren ist zunächst lediglich für die Alephino Standard-Datenbank, das ist jene mit dem Symbol B bzw. Datei DDBIBL vorbereitet.

Falls Sie das System-Benutzerkonto SYS entfernt oder dessen Passwort geändert haben, sind zuvor folgende Dateien entsprechend anzupassen:
a) unload.cmd in Alephino Release 3.0, Unterverzeichnis etc
b) upgrade.cmd in Alephino Release 5.0, Unterverzeichnis etc

Als erste Kommandozeile finden Sie jeweils login USER=SYS PASS=SYS; korrigieren Sie diese Angaben nötigenfalls.

Haben Sie gegenüber dem Auslieferungs-Standard von Alephino Release 3.0 signifikante Änderungen in den Generierungtabellen der Datenbank vorgenommen, tragen Sie diese unbedingt zuvor in Alephino Release 5.0 nach. Von Bedeutung sind Änderungen wie:
a) zusätzliche Stammdateien oder/und Felder in bestehenden Stammdateien (Datei etc/mabdata.int).
b) zusätzliche Datenpools (Dateien etc/alephino.cfg, etc/mabdata.int, etc/mabfile.ext)
c) zusätzliche Indexdateien (Dateien etc/mabindex.int)

Änderungen lt. a), die die Struktur der Datensätze betreffen, sind von essentieller Bedeutung, da hier die Gefahr von Datenverlusten besteht! Zusätzliche Indices etwa sollten sinnvoll beim Upgrade zugleich mit aufgebaut werden; dies kann aber auch nachträglich geschehen.

Wurden zusätzliche Datenpools definiert, ist das Upgradeverfahren für jeden Datenpool zu wiederholen. Zuvor muss wiederum in:
a) unload.cmd in Alephino Release 3.0, Unterverzeichnis etc
b) upgrade.cmd in Alephino Release 5.0, Unterverzeichnis etc

der zu bearbeitende symbolische Datenpool, d.h. die Angabe POOL= angepasst werden.

Infolge der Erfassung von Daten in Alephino oder der Übernahme von Fremddaten kann Ihre Alephino-Datenbank Sonderzeichen enthalten, die als Protypen dargestellt werden.
Nicht alle in Protypen verwendeten Codes entsprechen jedoch dem lt. MAB2 (ISO 5426-1983) definierten Zeichenvorrat.
So konnten in früheren Versionen bestimmte diakritische Zeichen durch Kombination mit einem Basiszeichen eingegeben werden. Bei der Konvertierung dieser Zeichenfolgen nach UTF-8 werden jedoch nur lt. MAB2 gültige Zeichenkombinationen berücksichtigt.

Wurden alle Datenpools erfolgreich umgesetzt, werden die Verzeichnisse upgrade nicht länger benötigt und können komplett gelöscht werden.

Die Arbeitsschritte im Einzelnen:

Wechseln Sie in das Verzeichnis bin Ihres Alephino Release 3.0 Servers, z.B. C:\Programme\Exlibris\MabServ_30\bin.

Führen Sie dort (unter Windows) unload.bat, unter Unix/Linux entsprechend unload.sh aus.

Wechseln Sie in das Verzeichnis bin Ihres Alephino Release 5.0 Servers, z.B. C:\Programme\Exlibris\AlephinoServer_50\bin.

Führen Sie dort upgrade.bat aus (Windows-Version).
Unix/Linux-Nutzer führen an dieser Stelle aus: upgrade.sh.
Bitte beachten Sie, dass während des Upgradeverfahrens ca. der doppelte Speicherbedarf als der Datenpool selbst beansprucht, auf dem aktuellen Laufwerk benötigt wird. Der gesamte Entlade- und Ladevorgang wurde hinsichtlich der Laufzeit gegenüber dem herkömmlichen Alephino-Import optimiert; wird aber dennoch einige Zeit in Anspruch nehmen.
Zum Vergleich: Ein Datenpool durchschnittlicher Größe (20.000 Titelaufnahmen) durchläuft auf einem PC mit Intel Celeron Prozessor, 2.6 GHz Taktfrequenz, 1 GByte Hauptspeicher das Verfahren unter WindowsXP in < 5:00 Minuten.

Traten im Verlauf des Upgradeverfahrens keine Fehlermeldungen auf, überzeugen Sie sich - nach dem Start des Alephino Servers - anhand des Logbuches und der zugehörigen Protokolle im Administrations-Modul von dessen Erfolg.

Nach Umsetzung eines Alephino-Datenpools erzeugen Sie vor Aufnahme der Datenerfassung mit Alephino 5.0 zunächst eine Alephino-Datensicherung. Löschen Sie dann alle zum betreffenden Datenpool gehörenden Log-Dateien, das sind alle Dateien im Verzeichnis pools mit demselben Stammnamen wie Ihr Datenpool, der Endung .log und weiteren Endungen .JJMMTT, z.B. DDBIBL.log*.

Update des Alephino-Servers ausgehend von Release 4.x

Das Setup-Programm übernimmt die Datenbanken (Pools) automatisch aus der vorhandenen Alephino-Installation:

Verzeichnis pools : DD???? (Alle Dateien im Verzeichnis, deren Name 6 Stellen lang ist und mit "DD" beginnt.)

Bitte beachten Sie:

Eine notwendige Korrektur der Indexierung für Rechnungsnummern hat zur Folge, daß ein aus Version 4.x kopierter Datenbestand in Version 5.0 nicht sicherungsfähig ist.
Bitte führen Sie daher folgende Arbeitsschritte aus:
1. Vor dem Upgrade in Version 4.x mittels Web-Services die betroffene Indexdatei Nr. 833 löschen:
  Administration->Löschen Datei(en)
  
  Ohne diesen vorbereitenden Arbeitsschritt erscheint nach der Übernahme des Datenpools in Version die Fehlermeldung "Abweichende Dateidefinition" (Error -237).
2. Nach dem Upgrade in Version 5.0 mittels Web-Services den Index der Rechnungsnummern aufbauen:
  Administration->Aufbau Index
Datenpools der Version 4.x sind unter Maßgabe der ausgelieferten Standardgenerierung binärkompatibel mit jenen der Version 5.0. Daher werden diese im Upgradeverfahren zunächst durch einfaches Kopieren übernommen, solange Sie der Namenskonvention DD???? entsprechen.

Die vorgenannte Kompatibilität ist nicht gewährleistet, sobald Sie zusätzliche Datenpools und/oder interne Dateidefinitionen der Datenbank individuell geändert haben. Betroffen sind die Dateien etc/alephino.cfg sowie etc/mabdata.int (MAB2-Generierung) bzw. etc/marcdata.int (MARC21-Generierung). Vor Inbetriebnahme der Datenpools mit Version 5.0 sind individuelle Generierungsänderungen aus Version 4.x zu adaptieren. Anderenfalls erscheinen Fehlermeldungen der Form "Abweichende Dateidefinition" (Error -237).

Vor Aufnahme der Datenerfassung mit Alephino 5.0 führen Sie zunächst unbedingt für jeden im System definierten Datenpool eine Alephino-Datensicherung durch.

Mit Alephino 4.1 wurde die Möglichkeit geschaffen, ein digitales Repository zu verwalten. Das standardmäßig als Wurzel des Repositories genutzte Verzeichnis data/objects oder ggfs. ein abweichend definiertes Verzeichnis wird beim Upgrade nicht berücksichtigt. Falls diese Funktion in Alephino 4.1 genutzt wurde, kopieren Sie die Daten bitte manuell in das entsprechende Verzeichnis in Alephino 5.0.